home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / conv / iff2obj.lha / Iff2Obj / Iff2Obj.doc < prev    next >
Text File  |  1992-12-08  |  3KB  |  81 lines
  1.                     Iff2Obj-Documention
  2.  
  3. Introduction:
  4.   Iff2Obj enables you to create linkable files out of binary files or out of
  5.   IFF-files. This is useful because the available C-compilers cannot convert
  6.   huge amounts of ULONG []={ _much_ data } :-(
  7.  
  8. Requirements:
  9.   AmigaOS2.0 and the iff.library
  10.  
  11. Gadgets:
  12.   - LoadBin
  13.       Loads a binary file to memory. The data will not be modified in any way
  14.   - LoadIff
  15.       Loads an IFF-picture to memory. A BitMap-structure is generated and
  16.       filled with information about width, height, depth and pointers
  17.       to the single bitplanes.
  18.   - SaveBin
  19.       Saves a linkable object-file with your binary data
  20.   - SaveIff
  21.       Saves a linkable object-file with at least the bitplane-data of your
  22.       IFF-file. If you selected the CMAP-gadget and/or BitMap-gadget then
  23.       these information are also included in your object-file
  24.   - CHIPMEM
  25.       When selected your data-hunk will get the MEMF_CHIP flag.
  26.       This only affects your data in case of SaveBin or your bitplanes in case
  27.       of SaveIff. CMAP and BitMap information are never put to chipmem !
  28.   - CMAP
  29.       The colormap of your picture is added to the object-file
  30.   - BitMap
  31.       A complete BitMap-struct with information about your picture is added.
  32.       This is a proper way to access your bitplanes i think.
  33.   - Label
  34.       Specify a label with which you can access the data in the object-file
  35.       from your sourcecode.
  36.       'label':
  37.           at this address you find the begin of your data or the begin
  38.           of the first bitplane.
  39.       'label'_bm:
  40.           here is your BitMap-struct if you saved with SaveIff
  41.           width, height, depth and pointers to your bitplanes are initialised.
  42.       'label'_cmap:
  43.           here is the colormap as USHORT[]. You have to determine the number
  44.           from 'label'_bm.
  45.  
  46. Example:
  47.     as 'label' choose mypic
  48.     the object-file is named mypicture.o
  49.     CMAP and BitMap and CHIPMEM were chosen.
  50.  
  51. The sourcecode (using C) should look somewhat like:
  52.     extern UBYTE mypic[];
  53.     extern struct BitMap mypic_bm;
  54.     extern USHORT mypic_cmap[];
  55.  
  56.  
  57. Author:    Michael Krause
  58. Email:    imkrause@techfak.uni-bielefeld.de
  59.  
  60. Distribution:
  61.     This program is Public Domain.
  62.     Do with it whatever you like !
  63.     I am not responsible for any damage this program may cause.
  64.  
  65. This program makes use of:
  66.    - Christian A. Weber's iff.library
  67.    - Jan van den Baard's GadToolsBox
  68. Thanks to these authors for their fine programs !
  69.  
  70. Without these development-tools this program would have my own hack-like
  71. assembler-iff-loader which is for sure unable to load some strange IFF-pictures,
  72. a cli-interface instead of a GUI and so on.
  73.  
  74. Further thanks go to:
  75. Markus Illenseer for the information about the C-Compiler unability to convert
  76.  large amounts of data
  77. Matt Dillon for DICE
  78. and all the PD/Shareware-authors who make the Amiga superior to all other
  79. 'homecomputers' ;-)
  80.  
  81.